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(57) Abstract: A network management system is provided that allows a user to configure multiple devices according to a consistent 
^ set of policies. The system includes a device learning module that can read configuration data from a network device and automat- 

ically match that configuration data to existing policies and components of policies within the system. The device learning module 
^ also identifies unknown configuration data, which does not match any existing policy. The system further includes a grammar builder 
^ that can parse the unknown configuration data and construct a component or policy from the unknown data, by matching the un- 
^ known data to a grammar of configuration commands for the network device. The system also provided auditing capabilities, where 

policies arc compared to running network configurations, and differences arc identified. 
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METHODS AND SYSTEMS FOR CONTROLLING 
NETWORK INFRASTRUCTURE DEVICES 

Background of the Invention 

[0001] Biterprise networks today are composed of hundreds to thousands of network devices 
5 arranged in such a way as to connect sites together, and provide both internal network resources as 
well as Intemet access to employees. Service provider networks are even larger, often composed 
of tens of thousands of network devices. These devices include routers, LAN switches, and 
firewalls, in addition to other types of specialized devices (e.g., bandwidth performance 
measurement and control, trafi&c 'load balancers," etc.). 

1 0 [0002] Virtually none of these devices are functional within the network when removed from their 
shipping boxes. Each device has the hardware necessary to perform its function, and each device 
typically has software which handles any higher-level processing as well as presenting a 
configuration interface to users. Generically, this software is referred to as the device's "operating 
system". For some devices, the operating system presents few options to the user and thus requires 

1 5 little setup before the device is functional within the network; an example would be the low end 
LAN Ethernet switches which are ubiquitous in many networks today. For higjier-end devices, 
such as those which run the **backbone" of most enterprise or Intemet networks, or devices within 
the corporate data center, the operating system can present a truly vast array of options which 
govern device functionahty. These options generally must be configured by the user before the 

20 network device is useable. 

[00031 Routers and switches from vendors such as Cisco Systems, for example, can require tens to 
thousands of individual configuration commands in order to function within the network. At the 
simplest level, the number and combination of commands required on a specific device is a 
fixnction of its role in the network, the network protocols used, the number and type of connections 
25 handled by the devices, and security measures employed on the network. 

[0004] The process for creating these configurations starts with the overall network design, which 
is often expressed by network engineers in diagrams of the physical network along with knowledge 
of which network protocols and other fimctionaUty is in use. Within organizations with more 
rigorous standards, configurations for classes of devices are oftm *templated," with examples of 
30 configurations set up by senior engineers and then used (with appropriate device-specific data) by 
engineers in the field who deploy and maintain devices. Templates may be stored in a version- 
control system, in order to track changes. In less rigorous organizations, templates may merely be 
word-processor documents or memos which outline standards for device configuratioiL 
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[0005] Once configurations are designed for each network device, the commands making up the 
configuration must be appUed to the device itself. Several mechanisms exist for doing so, ranging 
fi^om typing the configuration commands into the device's command-line interpreter to a number of 
ways to "download" the configuration conmiands all at once (TFTP, FTP, Secure Shell copy, etc). 
S This process is then repeated for all devices that need to be updated. 

(00061 The processes described above are tedious, time-consuming, and error-prone. Attempts 
have therefore been made to automate the routine aspects of these processes. Nearly every large 
network engineering organization, for example, will Ukely possess "scripts" or small programs - 
typically written in-house - to retrieve and possibly even "download" configurations to multiple 
10 devices, change passwords, or construct Usts of devices and configurations. Scripts of this type 
simply replace the repetitive aspect of logging in to many devices and typing the same commands 
repeatedly. 

(0007] Commercial attempts to automate device configuration essentially start firom this basis. 
Tools such as Resource Manager Essentials (part of the CiscoWorks family of network 
1 5 management applications) provide access to the configuration text within a web browser interface, 
and allow any edits to be easily dq)loyed to the running network device. Such systems typically 
also save each version of a configuration and allow users to view this history, displaying 
differences between configurations in a visual format; history is also usefiil for rolling back to an 
earUer configuration version and effectively erasing mistakes within the network. 

20 [0008] hi the description above, no mention was made of providing tool support during the process 
of designing the configuration. The simplest device configuration systems don't provide such 
support. Designing network configurations is left to engineers to work out by traditional methods, 
and then the design is manually translated into individual configurations. The appUcations simply 
allow the engineer to edit the configurations safely - i.e., within the context of the tool, before it is 

25 distributed to the network devices themselves. The simplest appUcations also manage devices 
individually - in other words, if changes need to be made to 100 device configurations, the tool 
would be used 100 times to edit 100 mdividual configurations. This may provide the safety of 
working offline but it does not make the process any more efficient. 

fOOOP] One ^proach to providing efficiency is to allow a conmion set of commands to be 
30 deployed to many devices at the same time, achieving a form of mass configuration. This 

capabihty goes by many names commercially (e.g.. Command Sets in Intelliden's product), and is 
referred to as a "template" herein. In the simplest implementations, templates are a set of complete 
commands (i.e., with data values filled in) which can be deployed to a set of network devices. In 
more complex implementations, templates may allow "variables" which serve as placeholders for 

2 
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data which need to be filled in based upon the individual device. Often, the user is prompted to fill 
in data values for each device, or provide a list of values. 

[0010] Several limitations exist for the '*pure template" approach as described above. With 
templates that are composed of complete configuration commands, it is difficult to create a well- 
5 factored set of truly generic templates which can reflect yoxir network design in a * formalized" 
fashion. The term '"normalization" is borrowed firom the field of database design, and refers to the 
situation that exists when each piece of data is reflected ui only one place within the database, and 
all pieces of data may be retrieved by a single well-defined query (however complex it might turn 
out to be). Normalization is an important goal for network configuration as well, because it reflects 
1 0 the state when each piece of network fimctionality can be changed with the minimimi of effort and 
the minimum impact on unrelated devices or fimctions. 

[0011] In a generic or *f ormalized" set of configuration templates, each aspect of the network 
design would exist in a single place. All devices which incorporated that aspect of network 
fimctionality could be updated by editing aad re-deploying that template. In order to accomplish 
15 this, templates cannot simply contain configuration commands; two other capabilities are useful in 
order to achieve fiill normalization. 

[0012] First, templates should not incorporate complete conmiands, but should instead be 
somewhat abstract. This capability allows tenq)lates can be adapted to the specific devices onto 
which the fimctionality will be deployed. The user experience may or may not be wholly abstract, 
20 but the underlying template should be stored as abstract versions of commands, with a process to 
translate them into final configuration commands appropriate to each device. 

[0013] Second, templates should allow for data references and queries, with a sufficientiy rich 
ability to cross-reference data within and between devices. This allows an abstract template (as 
discussed above) to incorporate data values which are appropriate to a given device - nothing need 
25 be 'liard-coded." This capability allows each piece of data (e.g., an Ethemet interface IP address) 
to exist in one location, and simply be referenced everywhere else. Whenever such a source behind 
a reference changes, each reference to that data should be updated as well. 

[0014] Thus there is a need for systems and methods of providing a normalized management of 
network designs and configurations, and allowing technologies for design to be algorithmically 
30 linked to actual device configurations. 

Summary of the Invention 

[0015) In an embodiment, software systems and methods for managing the configurations of all 
devices on a network, through subscriptions to a common database of policies, are disclosed. 
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These policies are an embodiment of "nomialized" configuration templates as discussed in the 
previous section; policies thus adapt thanselves to the specific device being configured, and can 
allow for device-specific data references and queries. 

[0016] Embodiments of the invention also maintain control over policy and data modifications, 
5 providing a complete version history for each element managed in the database. The method of an 
embodiment is thus a pohcy-driven or policy-based method for managing network device 
configurations. The system also incorporates a method for automatically updating the database of 
pohcies, xising a learning system that incorporates new syntax whenever encountered. 

[00171 The system of an embodiment also provides capabiUties that bridge the gap between 
1 0 configuration control and network monitoring. Because the system can analyze a native device 
configuration and return the Ust of pohcies implemented, it can continually re-analyze devices and 
monitor changes to dcAdces at the pohcy level. Using this technology, the system alerts users when 
devices fail to implement the intended pohcies or when changes made outside the system, such as 
manual changes made by network engineers, cause divergence among devices. 

1 5 [0018] Additionally, embodiments of the invention are designed to overcome the limitations of a 
*^ure template" approach, provide "nomialized" management of network designs and 
configurations, and allow technologies for design to be algorithmicaUy linked to actual device 
configurations. 

[00191 Another aspect of an embodiment of the invention is the degree to which the structure of 
20 the configuration, as well as the semantics of configuration commands, are parsed and understood 
by the automation tool. Earlier s^proaches to the problem treat commands and configurations as 
blocks of text which have meaning to the human user, and to the network device, but not to the 
automation tool. Anottier aspect of an embodiment of the invention is that device configurations 
are written in a "regular language," and thus are amenable to the standard tools of hnguistic 
25 parsing, analysis, and generation. 

[00201 Configuration comprehension is realized in an embodiment of the invention by the use of a 
compiler which handles both the incoming parsing of native configurations and outgoing 
production of new native configurations. Because embodiments of the invention are designed to 
control many different types of hardware from multiple vendors, this compiler is modular, allowing 
30 the same "source code" (e.g., a tree of configuration elements) to be translated into different 
"executables" (e.g., the specific configuration languages of different vendors). 

[00211 Some vendors (e.g., Cisco Systems) have many product lines, often with different operating 
systems and different command languages. Each vendor (and operating system) supported by 
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embodiments of the invention thus has a formal grammar, which was initially produced by hand 
For each unique combination of vendor and language^ a formal grammar and methods for 
interacting with the device to retrieve and update configurations are used. 

(0022J In addition, aspects of embodiments of the invention allow grammars to be extensible at 
5 runtime, since vendors fi-equently add new commands whenever new hardware or new 

jEunctionality appears within a product line. Within embodiments of the invention, grammars are 
expandable without additional programming, because the parser is designed to recognize (and 
isolate for analysis) sections of native configurations which do not match any known device 
configuration command. Segments of native configuration representing unknown syntax can then 
10 be tumed into fiiU grammar through a systOTi for discovering and automatically writing new 

grammar segments. These new grantunar segments can then be inserted into the grammar database 
and used immediately for parsing incoming native configurations or compiling new configurations 
for output to a network device. 

[0023] At a high level, the system of an anbodiment can be broken into two major functional 
1 5 areas. First, the system allows large numbers of network devices to be configured and controlled 
using flexible policies which are easily created by users of the system without writing any 
programming code or understanding the inner woiidngs of parsers or compilers. Second, the 
system incorporates innovations that are designed to automatically incorporate new information 
about changes that hardware vendors make to their product lines, without requiring an update to the 
20 system code. 

Description of the Drawings 

[0024] The accompanying drawings are included to provide a further understanding of 
embodiments of the invention and togettier with the Detailed Description, serve to explain the 
principles of the raibodiments disclosed, 

25 [0025] FIG, 1 depicts a network management system in accordance with an embodiment of the 
invention. 

[0026J FIG, 2 depicts an instance tree for a policy-driven configuration. 
[0027] FIG. 3 depicts a pohcy for use with a pohcy-driven configuration. 

[0028] FIG. 4 depicts a native configuration as parsed by the device learning system of an 
30 embodiment of the invention. 

[0029] FIG. 5 depicts the stages of parsing a native configuration into a policy-driven 
configuration according to an embodiment of the invention. 
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. [0030] FIG. 6 depicts a method of parsing a native configuration. 

[0031] FIG. 7 depicts a method of identifymg policies contained in a parsed configuration. 

[0032] FIG. 8 depicts a method of handling parsing errors. 

[0033] FIG. 9 depicts an instance tree containing recognized components and unknown regions. 

5 [0034] FIG. 9A depicts an uiiknown region contained witliin a recognized component. 

[0035] FIG. 10 depicts a method of processing an instance tree to recognize candidate 
components. 

[00361 FIG. 1 1 depicts a generalized method of resolving candidate con^onents into components. 

[0037) FIG. 12 depicts a method of creating an abstract syntax tree for a command root. 

1 0 [0038] FIG. 1 3 depicts an abstract syntax tree created according to the method of FIG. 12. 

[0039] FIG. 14 depicts a method of transforming an abstract syntax tree into a grammar for a 
component. 

[0040] FIG. 15 depicts a method of identifying command boundaries within a grammar tree. 

[0041] FIG. 16 depicts a method of discovering command-level semantics caused by alterations to 
15 configurations. 

[0042] FIG. 17 dqpicts a method of identifying default values and equivalencies in command 
attributes. 

[0043] FIG. 18 depicts a method of identifying attributes which can create unique instances of a 
component. 

20 [0044] FIG. 1 9 depicts a method of identifying addition dependencies in a configuration. 

[0045] FIG. 20 depicts a method of identifying removal dependencies in a configuration. 

[0046] FIG. 21 depicts a component having multiple alternative sets of syntax bloclcs. 

[0047] FIG. 22 depicts a method of compiling a policy-driven configuration into a native 
configuration. 

25 [00481 FIG. 23 depicts a method of applying a native configuration to a network device. 

[0049] FIG. 24 depicts a method of auditing a native configuration against a poUcy-driven 
configuration, to detect differences between the two. 

[0050] FIG. 25 depicts a method of auditing a native configuration to ensure network design 
consistency is maintained. 

6 
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Detafled Description of the Preferred Embodiments 

[0051] In the system of an embodiment shown in FIG. 1 , network device data stmctures 12 are 
data structures that represent physical devices 10. Examples include routers, switches, or firewalls. 
Each physical network device 10 is represented by a network device data structure 12, which is 

5 stored in the network device database 14. Customers purchase a software hcense which enables a 
fixed number of device data stmctures 12 to be created and stored in the device database 14, 
Additional Ucenses to create and store device data structures 12 can be purchased throughout the 
lifetime of the product. Each device data structure 12 contains metadata (information) concerning 
that device 10, such as information about the device vendor, software operating system or 

1 0 command language version, and the appropriate methods and authentication credentials for 
executing commands on the device 10. Each device data stmcture 12 also contains a native 
configuration for the associated network device 10. Furthermore, the network device data stmcture 
contains pointers to user-created metadata about the device. These metadata include categories and 
groiq)ings useful for organizing a large number of devices, as well as for creating policies. 

1 5 [0052] Each network device 10 is associated, via a network device data stmcture 12, with zero or 
more Policy-Driven ('TD") configurations 16, each of which represents a complete set of 
directives needed for the physical network device 10 to fimction in an intended manner. These PD 
configurations 16 are stored in a component database 28. In an embodiment, a network device has 
one "active" configuration at any time, and the user can switch active status between any of the 

20 stored PD configurations 16 associated with a device 10 at any point in time. In an alternate 
embodiment, a network device 10 can have more than one active configuration 16. 

[00531 Policy-driven configurations 1 6 are data stmctures which represent the total desired state of 
a network device 10 within the system. PD configurations 16 contain references to a set of 
instances 20, poUcies 34, and device data stored in persistent storage 22. The instances 20 are 
25 stored in the component database 28. 

[00541 In terms of implementation, PD configurations 16 are a set of references or pointers to 
instances 20 of .components 26 stored elsewhere in the component database 28, or policies 34. 
Components 26 are not directly used by device configurations 16. Instead, following object- 
oriented practice, "instance" objects, i.e. instances 20, are created whenever a component 26 is 
3 0 attached to a PD configuration 1 6. Instances combine a reference to a component 26, and device- 
specific data stored in the device data storage 22. Policies 34 are persistent groups of instances 20 
which can be reused across many PD configurations 16, 

[0055] If an instance 20 is created purely to serve within the context of a single device 1 0, the 
system creates a ''private" or anonymous instance 20 of the component 26, which contains both 
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syntax and references to device-specific data which are retrieved &om storage 22 in the process of 
resolving data references set up in the grammar. Private instances do not show up in the catalog 46 
of components displayed to the user for reuse, since private instances are not reusable. 

[00561 If an instance 20 is created to be used on more than one device 1 0, the system creates a 
5 poUcy 34 which is a public instance of the component Policies may be reused on any number of 
devices 10, and may include entire collections of instances 20 and data references. Pohcies thus act 
like 'templates*' which aggregate together functionahty, saving manual configuration effort and 
increasing consistency and accuracy across the customer's network. Policies are displayed in the 
catalog 46 of components for use by the user, and stored in the component database 28. 

1 0 [0057] Some of these data references may be partially filled because their values are not device- 
specific (e.g.., routing protocol parameters which are constant across devices but need to be 
customized for the user's particxdar network), while other data references are resolved for each 
device configuration 16 to which the pohcy 34 is attached. 

[0058] PoUcies 34 are the means by which configurations can be factored into larger-scale units 
15 and reused. Policies 34 create a "change once, apply everywhere" semantic to network device 
configuration, and are the principal mechanism for decreasing the effort required to run a network 
using the system. When pohcies 34 are added fi:om PD configurations 16, we keep a database 
record of the policy linkage 35. This linkage is used in advanced device monitoring and auditing, 
as described below. When a poUcy 34 is removed &om PD configurations 16, the ^propriate 
20 policy linkage 35 is removed firom the database record of policy linkages. 

[0059] Turning to FIG. 2, instances 20 in a PD configuration 16 are organized in a strict tree 30 
which organizes instances 20 into a series of containers 32 which correspond to vendor-neutral or 
abstract networking concepts. This tree 30 does not necessarily correspond to the topology of the 
actual grammar of the vendor's command language as stored in the totality of syntax blocks stored 

25 in instances 20. The mapping between the two is handled by custom directives embedded in a 
grammar specification language, which allow reorganization of the component tree 30 along \yith 
subsequent compilation using tiie "correct" set of syntax (derived from the instance tree 30), as 
discussed in detail below. The containers 32 are present in the catalog 46 of components and 
policies, and are used to constmct a human-readable representation of the catalog within the user 

30 interface 40. 

[0060] Turning to FIG. 3, a poUcy 34 represents a reusable set of instances 20. At the top of FIG. 
3, a single instance 20 is expanded to show its intemal structure. Within the instance 20, is a 
collection of syntax blocks 36, for example one or more configuration directives, possibly 
associated with configuration data 38. Pohcies 34 may contain other policies as well, which means 
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that an instance often points to zero or more child sub-policies 40. When compiled into a native 
configuration, instances 20 and any sub-policies 40 which are included in a policy 34 are compiled. 
This behavior allows the creation of reusable policies which lessen the work required to create 
standardized sets of network devices. 

5 10061] At the lowest level, the system of an embodiment contains a set of component syntax 
blocks 36 for a given network device vendor or configuration language. These components are an 
object-oriented view of tiie grammar specification for a given configuration language, and as such 
are abstract. In other words, device-specific data 38 is usually not associated with the component 
syntax blocks 36. In alternate embodiments, however, device-specific data 38 may be associated 

1 0 with a component syntax block 36, for example if the configuration language itself is device- 
specific. References to device-specific data 38 are denoted in the syntax block 36 by a 'Variable" 
or "placeholder" grammar constmct that indicates that a position within the syntax block 36 is to be 
filled in with the results of a database query into device data storage 22, for example when the 
component 26 containing the component syntax block 36 is instantiated into an instance 20. 

1 5 Component syntax blocks 36 are editable using a component editor 41 within the user interface 40 
using a simplified graphical method for adding, deleting, and modifying syntax block elements. 

[0062] Component syntax is created in several ways - by direct creation within the user interface 
40 using a component editor 41, by downloads 42 received firom an outside source such as a 
manufacturer of the system or a third party component creator, or by Grammar Builder 45. 
20 Grammar Builder 45 allows the system to "leam" new syntax by analysis of candidate components 
58 for syntax that is not recognized as part of the existing component database 28. Grammar 
Builder 45 is described in detail below. 

10063] Physical devices 10 possess a single running configuration at any one time - the set of 
commands, language directives, and data used by onboard operating system software or firmware 

25 to produce ttie running behavior of the device. This is referred to as a "native configuration". 

Some devices can store alternative configurations in memory or persistent storage (e.g., Cisco lOS 
devices store startup configurations in NVRAM, and these can be separate in some cases firom the 
running configuration in RAM). Native configuration refers to ttie set of commands, directives, 
and data stored on a physical device, whether running or alternate. Native configurations are 

30 retrieved, stored in the device data structures 12, and analyzed during device registration, and are 
created by the DLS 44, for loading onto the network device 10, when compiling a PD 
configuration 16 during preview or task execution. Native configurations may also be revised 
directly on the network device 10, for example by an engineer performing a manual update 48. 
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Manual updates may occur during troubleshooting or in order to install a change recommended by 
the network device vendor. 

[0064] Policy-driven configurations 16 (as well as components and data) are version-controlled 
within the system. These entities are edited by checking out the entry into a local workmg area 
5 within the user interface 40. This working area is referred to as a '^workspace " and workspaces 
can be personal or shared by a group of users for collaborative work. Entities which are edited 
within a workspace are then checked in, creating a new persistent version of the entity. Users can 
browse the history of each entity, and roll back the current state of an entity to a previously stored 
versioru 

1 0 [0065] Editing is done in the context of a "job", which serves as a container within the user 

interface 40 for organizing the work needed for accomphshing a real-world project Examples of 
projects range in scope from "deploying a new Ethemet switch" to "create an enterprise-wide mesh 
of VPN tumels." Projects begin with the editing of ^tities within a workspace - for example, PD 
configurations 16 or policies 34, and are finished when each device 10 requiring update has 

1 5 received the changes which result from such edits. 

[0066] Within a job, edits to a poUcy 34 may affect many different network devices. 
Dependencies between network devices and policies 34 are maintained within the system (as a 
series of policy linkages 35), so that a task may be created for each device 10 affected by edits to a 
policy 34. Oianges to private instances 20 within a PD configuration 16 also trigger the creation of 
20 a task for updating the network device 10. Tasks are workflow items, owned by a user of the 
system and requiring resolution before a job is completed. 

[00671 The system of an embodiment is designed to automatically track changes made by network 
hardware vendors to their command languages and syntax. Previously, products either forced the 
human user to track vendor changes, or wait for the software solution vendor to produce product 
25 updates. 

[0068] The process of importing networic devices 1 0 into the system may involve both making 
entries into a device and hcense inventory database 14, and the retrieval and analysis of the native 
configuration running on the device 1 0 at the time of import. The latter activity is performed by the 
Device Learning System 44, as discussed in detail below. 

30 (00691 The database 14 of basic device information is a standard SQL database used to record the 
name and other metadata concerning each network device 10. Examples of metadata include the 
location and model number of each network device 1 0. These metadata are used for grouping and 
sorting functions within the syst^'s user interface 40. 
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[0070] la an embodiment, entries made in the device inventory database 14 are tracked against the 
customer's purchased license. A "grace period" is activated when the inventory reaches the total 
purchased license, allowing the customer to exceed their paid license account for a temporary 
interval while they acquire additional licenses from the system vendor. This feature is for customer 
5 convenience, and can be disabled within the system if deemed desirable. 

[0071] Importmg native configurations from the nmning device 10 accompHshes two goals. First, 
import of the existing native configuration saves a significant amount of re-work by customers, 
thus easing adoption and speeding the utiUty of the system for customers. Second, importation and 
subsequent analysis of the parsed configuration is usefiil in Grammar Builder 45 - which allows 
1 0 for extending the database 28 of conq)onents and policies without significant manual effort on the 
part of the customer or vendor. 

[00721 Turning to FIG. 4, in an example of the operation of the Device Learning System 44, a 
native configuration SO imported from a running netwoik device 10 will contain sets of 
configuration commands 52 that ahready exist in recognized component form 54 within the system, 
15 as well as some constructs 56 which are not represented by recognized components 54. Those 
constructs 56 which are not represented by recognized components 54 are subsumed by candidate 
components 58 which can be later analyzed by Grammar Builder 45. 

10073] Turning to FIG. 5, a high level view of the stages of the Device Learning System 44 are 
shown. The Device Learning System 44 begjms with the native configuration 50 as an ^ The 

20 native configuration 50 is provided to a lexer module 60, where each of the literal strings in the 
native configuration 50 is assigned a token ID (tokenized). The tokenized configuration is emitted 
as a data stream to a parser 62, which parses the configuration into either recognized components 
54, or candidate components 58. The parser 62 is configured using the components 26 in the 
component database 28, such that the parser will recognize any components in the native 

25 configuration 50 which match components 26 stored in the component database 28. The lexer 60 
is also configured using the components in the conocponent database 28, such that the lexer 60 wiU 
recognize the tokens used in the grammar embodied in the components 26. Then, the set of 
components is analyzed by policy matcher 59 to determine which, if any, poUcies 34 are 
represented. The result of Device Learning System 44 analysis is a Policy Driven Configuration 16 

30 and zero or more candidate components 58. 

[0074] Configuration analysis and configuration compilation use the same parsing engine. This is 
done to allow the component structure to be used synmietrically - either in parsing and analysis of 
an existing device 10, or to be used as a specification for emitting a new native configuration 50 at 

compile time. In an embodiment, the parsing engine uses a custom granomar specification 

11 
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language discussed below, rather than a Y ACC-style grammar specification. Alternatively, a 
YACC-style granamar specification may be used, 

[0075] The custom grammar specification language of an embodiment uses a very close coupling 
of the lexing (tokenization) and parsing Amotions in order to deal with complex configuration 
5 languages - many of which were not "designed" but rather evolved over many releases. In contrast 
to a typical YACC-style grammar specification, where semantic actions are explicit within the 
grammar, the custom grammar specification language avoids explicit semantic actions in order to 
use the same grammar specification for both analysis and configuration compilation. S^antic 
actions refer to the code executed when a specific syntactic construct is matched by the parser 62 - 
10 the action might be to insert the parsed data into a data structure, or to execute some application 
fimctionality, for example. The custom grammar specification closely couples the lexer and parser 
in order to implement one step in the analysis of candidate components 58. 

[0076] Within the system, semantic actions are left implicit in the grammar specification, and are 
inferred based on the type of parser being constracted - an analysis parser 62 (for analyzing 

1 5 existing configurations) or a compiler (for creating configurations 6om components). In the case 
of an analysis parser 62, semantic actions include creating an in-memory tree representation of the 
configuration syntax, along with "actions" which reorganize the tree and insert parsed data into the 
appropriate class objects as member variables. In the case of a generated compiler, semantic 
actions include resolving data references and emitting * instructions" in the form of syntactically 

20 correct configuration commands in the relevant device vendor's language (e.g., Cisco lOS). 

[0077] In order to create a learning effect, the analysis parser 62 is fi:eshly constructed prior to 
importing the native configuration 50 fiom a new device 10 (although caching can be used as an 
optimizatioii where ^propriate). In other words, the contents of the component database 28 are 
used to constmct the lexer 60 and parser 62 anew for each run. This means that as components 26 
25 are added - either directly in the GUI or through Grammar Builder 45 - the parser 62 becomes 

incrementally richer and better able to recognize Ihe user's configurations at a component or pohcy 
level. 

[00781 With reference to FIG. 6, in the first step 610, the grammar specification (in NC format) is 
scanned to develop a mapping of literal strings into lexer tokens. This mapping is used to generate 
30 the source code for the lexer module 60, which is used by the parser 62 to scan the native 

configuration text at a low level and retum a stream of tokens rather than literal ASCII text. Both 
the lexer 60 and parser 62 source code are created by combining the processed granMnar 
specification with source code templates which contain common constructs which aie invariant 
&om run to nin of the system. 

* 

12 
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[0079] ia the second step 620, the source code for the parser 62 is generated, by iterating over the 
grammar rules contained in each component 26 and creating a YACC-cornpliant rule. For each 
grammar rule contained in each component 26, the system generates a YACC rule which matches 
tokenized syntax seen in the configuration being analyzed. The system also generates an 
S appropriate semantic action for each rule. In the case of configuration analysis, semantic actions 
involve instructions for building an in-memory representation of instances of recognized 
components S4 as well as insertion of data into objects as member variables, plus some 
reorganization of the resulting "instance tree " Grammar mles ai'e sometimes rewritten to turn the 
more compact and expressive Extended Bakus-Naur Form (EBNF) syntax specifications into 
1 0 YACC-style BNF (Bakus-Naur Form) specifications. Rewriting is done whenever necessary. 

[0080] Once the source code for the lexer 60 and parser 62 are generated, at step 630 each is 
compiled and then dynamically loaded by the Device Learning System 44. The system is now 
ready to the parse the native device configuration 50, which has been previously retrieved. The 
generated parser may be LALR (Look Ahead, Left Recursive), or altematively may be a GLR 
1 5 (Generalized Lefl: Recursive) parser, in order to allow resolution of certain ambiguous command 
syntaxes found in some native configurations. 

[0081] At step 640, the parser 62 is run with the native configuration 50 as input, with parsing 
occurring in a fairly normal fashion, except for handling of parse errors. As the parser 62 receives 
a stream of tokens from the lexer 60, it matches sequences of tokens which form rules in the 
20 grammar which was synthesized fi'om the cunr^t state of the component database 28. 

[0082] Each rule corresponds to the syntax 36 of a siagle component 26, e3q)ressed in YACC-style 
specification. When a rule is matched in the native configuration input, a component instance 
object is created and added to an instance tree maintained by the parser 62. In addition, semantic 
actions are triggered which handle additional instance construction activities, such as copying 
25 parsed data values into object member variables. 

[0083] In conventional parsing implementations, a parse error would indicate that the parser 62 
encountered syntax which is illegal given the parser's grammar definition. In the parser 62 of an 
embodiment, since the parser grammar is generated from the library 28 of components, parse errors 
represent configuration commands that are not yet part of the component database 28. Thus, parser 
30 exceptions which result from unknown grammatical constmcts are handled in a separate step, to 
create candidate components 58 before the configuration is given to the user for viewing and 
editing. Recognition of candidate components 58 through parse error handling is described in 
detail below. 
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[0084] Once the parser is finished parsing the native configuration 50, at step 650 it returns a data 
structure called an "instance tree." This data structure contains instances 20 which house not only 
the parsed syntax but also named member variables that were recognized during parsing, organized 
in strict conformance to the topology of the origmal grammar specification. 

5 [0085] The instance tree is relatively flat after parsing, and thus is reorganized along a number of 
dimensions at step 660. Hints in each component's stored syntax are used to move instances 
around within the instance tree. This is done, for example, to group together related instances (e.g., 
ACL entries, routing advertisements). Tree reorganization serves to both enhance user 
comprehension, and also provide hooks for implementation of vendor-neutral conqwnent 

1 0 relationships and other post-processing based on metadata. Following recognition of candidate 
components 58 at step 670, the tree is then compressed to remove empty mstances following 
reorganization and generally collapse redundancies at step 680. Again, this is done both to enhance 
user comprehension, and also to provide a post-processing hook for cleanup following other post- 
processing based on metadata. 

1 5 [00861 Finally, at step 690 flie instance tree is analyzed at the policy level to detect nodes which 
rq)resent instances of pohcies 34 stored in the component library 28. Policy analysis begins with 
the instance tree as it exists after parsing and reorganization. This instance tree contains references 
to base components 26 and associated data found during parsing. At the level of policies, which 
can span many devices, none of the recognized components 54 recognised during parsing are yet 

20 understood. 

[0087] Recognition of policies occurs by attempts to match policies against the instance tree, as 
shown in the method of FIG. 7. For each poUcy 34 stored in the database 28 and retrieved at step 
705, we attempt to match the first sub-component contained in the poUcy against the device 
instance tree at step 710. If no match occurs, then the poHcy is not represented on a device and we 
25 abort to the next policy in the hst (because the entire pohcy must match to be recognized) and 
return to step 705. 

[0088] At step 7 1 5, if the first contained sub-component is matched at one or more places in the 
instance tree, we then look at two sub-cases. Some policies simply aggregate a set of components 
and data for use as a '^package" or poUcy. In these cases, the order in which components are 
30 recognized in the tree does not matter. In other cases, however, order matters. Route maps or 
access control lists (both of which are represented as policies) aggregate together components, but 
do so in a particular order. Processing branches to step 720 for unordered policies, and to step 730 
for ordered policies. 
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[0089] For an unordered policy, at step 720, the next sub-component in the instance tree is checked 
to see if it matches a component in the policy. If not, we abort to the next policy to be recognized, 
at step 705. When we find a match between the first sub-component of a policy and the device 
instance tree, it is sufficient to singly find matches for the remainder of the policy sub-components 
5 elsewhere in the instance tree within the sub-tree of the node which contained the first component 
match. The latter requirement prevents situations where trivial matches in widely disparate 
segments of the tree are misinterpreted as the presence of a policy on a device. As each component 
is matched to a policy, a check is made to detennine if the poUcy is fiiUy matched, at step 725. If it 
is, then processing advances to step 740, otherwise the next component in the instance tree is tested 
10 at step 720. 

[0090] For an ordered policy, at step 730, the next sub-component in the instance tree is checked 
to see if it matches a component in the policy. If not, we abort to the next policy to be recognized, 
at step 705. Once we match the first sub-component within the instance tree, we then walk the 
remainder of the sub-components in order to detennine if they match the instance tree in the correct 
1 5 order. Only if all components contained within a policy match components found in the instance 
tree, in the correct order, is the policy called a '"match." As each component is matched to a policy, 
a check is made to determine if the poHcy is fiiUy matched, at step 735. If it is, then processing 
advances to step 740, otherwise the next component in the instance tree is tested at step 720. 

[0091] Assuming that a policy is matched in the instance tree, we then replace the original 
20 components within the instance tree with the policy itseU^ at step 740. This is done by finding the 
site in the instance tree at which the first sub-component of the policy matched the instance tree, 
and replacing that component with the policy itself All other sub-components which matched are 
then simply deleted firom the instance tree in order to prevent duplication. 

[0092] This process is repeated for all poUcies in the poUcy database. The end result of this 
25 analysis is an instance tree which contains any poUcies which the device implements, any 

components wtiich are identified within the device configuration but are not part of a policy, and 
any candidate components which are recognized for the first time. Such an instance tree is 
considered '"complete" and is the output of the Device Learning System 44, and is ready to be 
stored persistently to the compon^t database 28 and within a version control database. 

30 [0093] Once post-processing is complete, the instance tree for a device configuration is complete, 
and can be persistently stored to versioned storage within the system. At this point, the 
configuration represents a PD configuration 16. 

[0094] hi an embodiment, the instance tree is persisted to an XML data format, and stored as a file 
in a version control database. Once stored in version control, we can reconstruct the change history 

15 
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of the configuration between any two editing sessions (so long as an editing session is saved and 
not abandoned or purged). 

[0095] In the text above, we described Ifae overall method of an embodiment, for parsing the native 
configuration and recognizing instances 20 of library components 26. We also described the fact 
5 that parse errors indicate that the parser has encountered configuration syntax that is not contained 
within any recognized component 54. Thus, the syntax errors themselves represent a significant 
source of information about potentially new components. The method for handling parse errors is 
described in detail below. 

[0096] Under normal usage, a conventional parser stops parsing when a syntax error is 
10 encountered, and rq)orts the error and the ojQfending syntax to the caller. This approach is typically 
seen within compilers, for example. Thus, the location of the error is known. 

[0097] Within the parsing step 640 performed by the Device Learning System 44, parse errors are 
processed according to the method of FIG. 8. Parse errors are trapped and marked for later post- 
processing at step 810. Instead of adding a normal component instance to the output tree, an 
1 5 "unknown" region marker is added to mark the spot, at step 820. Parsing then continues at step 
830 until the next error occurs or the end of the iaput configuration SO is reached. The resulting 
output is therefore an instance tree 71, which is a tree-organized data structure, composed mostiy of 
component instances 72 with data, and an occasional *^lnknown" region 74, which marks a place 
whore un-parseable syntax occurred. 

20 [0098] At this stage, however, the Device Learning System 44 does not loaow the extent or 

contents of the '"unlcnown" region 74, since this syntax was un-parseable and no semantic actions 
were taken. Only the location is known. Resolution of'*unknown" region markers into candidate 
components 58 is done by post-processing flie instance tree 71 in combination with the token 
database built by the lexer 60. 

Lp' address^ 192,168,1.1- 255,255.255.252^^ W 

Table 1: Example native syntax, tokenized with token ID's (third line is "unknowtt " syntax) 

[0100] During the initial parsing run, as discussed above, the lexer 60 feeds tokens to the parser 62. 
The lexer 60 also builds a table of tokens with unique identifiers (IDs) which radicate the order in 
which tokens were found in the original input text (Table 1). The parser 62 records the unique ID 
30 for each token in the instance tree 71 with each token making up a matched rule (Table 2). Token 
IDs are used during post-processing to isolate and identify the contents of unknown syntax regions 
which become candidate components 58. When an '*unknown" syntax region 74 is encountered 

16 
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through the parse error handler, it is marked with the token ID of the token where parsing failed to 
reduce a grammar rule (in the Table 1 example, ibis is token #10) 



Token UaadFlag 

interface 

serial 

l/C 

\r. 

ip 

\n 

nsQC 

3CC 

\n 

bandwidth 



Table 2: Lexer toke^i database 



5 [0101] Turning to FIG. 10, after initial parsing, during post-processing (step 670 of FIG. 6), the 
output instance tree 7 1 is walked in order to resolve the extent and contents of each unknown 
marker 74, at step 1010. Each instance object 72 in the tree contains a sequence of tokens which 
make up the syntax of the component instance. For each token referred to within an instance 72, at 
step 1020 we look up the token ID within the lexer's internal database and matk it as used (Table 
10 3). Thus, at the conclusion of the instance tree traversal, each token making up the syntax of 
known components 54 is marked within the lexer database. 





Token 








X 




serial 


X 


3 


l/C 


X 




\n 


X 


•> 


ip 


X 


6 




X 


n 


192,168.1.1 


X 


8 


255.255,255.252 


X 




\n 


X 


10 


carries— deiay 




11 


nsec 




12 


300 




L3 


\n 




14 


bandwidth 


X 


15 


1534 


X 


16 


\n 


X 



Table 3: Lexer token database, post-processed to mark tokens used in recognized components 

[0102] As a result, any tokens that remain unmarked within the lexer database are necessarily part 
15 of syntax regions which do not match anything in the component database 28. Furthermore, each 
unknown syntax region 74 is associated with some contextual information concerning association 
with other components (depending upon the nature of the vendor configuration language), because 
of the position of the unknown region in the parsed instance tree 71 (See FIG. 9 A). For example, 
referring to FIG. 9A, the "unlaiown" sub-component 75 is known to be a sub-component of the 
20 known "interface" conq)onent 77, because the unknown region 74 is located in the parsed instance 
tree 71 between two known sub-components 78, 79 of the '^interface" component 
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[0103] At stq) 1 030, we walk the instance tree again, sequentially post-processing each 
'^inknown" region marker 74. The token ID listed in each unknown marker 74 is followed into the 
lexer's token database at step 1040. This token ID only marks a spot within the lexer database - 
we stiU know nothing about the extent of the region. To resolve the extent and contents of the 
unknown region, we therefore walk the lexer token database in both directions from this starting 
point, until we encounter tokens that had been previously marked as 'Hised" by existing instances at 
step 1050. The region between these boundaries is thus the contents of a new candidate component 
58 which replaces the unknown marker 74 in the ou^ut instance tree (Table 4). Finally, at step 
1060, the tokens which made up the unknown region 74 are then marked as '^ised" to prevent 
future passes through the lexer database from encountering the same unkuown twice. 

— — Mjuiq - "^aariAl 1/0" 
—— Address « *1<I2. 166.1.1" 

NetmAsk - »^2SS.255.25S.252'* 

— Bandwidth ' "1634" 

Coaipoftftntj Candida t« 
* InknowH^ayntax: •*carrUs-da:ay laase 300* 

Table 4: Post-processed instance tree fragment, with candidate component inserted in proper 
context 

[0104] The resulting candidate component 58 is not yet stored within the component database 28, 
1 5 but it is a fuUy featured component instance and is persisted as part of the final device 

configuration. At this point, the candidate component 58 is private, occurring only within a single 
device configuration. It cannot be reused or referred to by name. This allows new syntax to be 
tried within the context of a single device 10 without side effects on the network as a whole. 
Candidate components 58 become available for reuse when or if Grammar Builder 45 converts the 
20 candidate components 58 to components 26. 

[0105] The method used to resolve unlmown regions 74 into candidate components 58 is "greedy" 
in the sense that adjacent unknown regions are collapsed into a single candidate. This effect occurs 
because we walk the lexer database in both directions flom the initial token ID which serves as a 
pointer into the database. The first pass through a given unknown region 74 thus consumes all of 
25 the unmarked tokens found, associating them with the first candidate created in a given region. 
When further unknown markers in an adjacent set are post-processed, no unused tokens are found 
in the lexer database upon de-referenciag their pointer ZD's. To simplify the implementation, 
empty instances are created in such situations, which are compressed out of the final instance tree 
during the late stages of post-processing as discussed above. 

18 
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[0106] Once the candidate components 58 have been identified using the methods discussed 
above, these candidate components 58 are then resolved into formal grammars 70 by the Grammar 
Builder 45 system. Automated grammar production is a three phase process as shown in FIG. 1 1 . 
In the first phase at step 1110, a mechanism is used to acquire a syntax tree for a set of commands. 
5 As an example, within the command interlace on Cisco lOS devices, the command interpreter 
provides **tab completion'* and limited help or prompting for commands. This facihty is sufficient 
to discover the syntax of unknown commands. Any other method of acquiring these data is also 
acceptable, so long as the resulting information is accurate (for example, it is also possible to parse 
electronic documentation.) 

1 0 [0107] In the second phase at step 1 120, the syntax tree is transformed into a usable componmt 
tree according to a set of algorithms which is partially vendor-neutral, but also including specific 
transformations appropriate to a specific command language. In the third and fiunial phase at step 
1 130, vendor-specific mechanisms are used to examine semantic, rather than syntactic, issues with 
how commands are added and removed fi:om a device, and any "side-effects" they may have 

1 5 within the configuration. Semantic information about component interaction is added to the 
grammar in the form of "tags" which can be used by other ^plications in addition to the Device 
Learning System 44. The resulting grammar is then "con:9)lete" apart firom any adjustments that 
are made to the quality of labels (since automatically generated labels are ofl:en fairly difficult for 
human users to comprehend). 

20 [0108] Turning to FIG. 12, acquisition of an abstract syntax tree (Phase I) begins with identifying a 
set of "conmiand roots" - e.g. the first several tokens that make up a command in a line-oriented 
configuration language. Roots serve to define the starting point and "breadth" of a syntax tree 
search. As an example, we will use the command **ip route 10.0.0.0 255.0.0.0 192.168.1.100 10", 
which adds a static route to the IP network 10.0.0.0 via the network link located at 192.168.1.100, 

25 with a "distance" (or preference, essentially) of 1 0. The "command root" we will start with is the 
partial command "ip route," and our goal will be to automatically discover the syntax of "ip route" 
commands in lOS 12.2. Starting points are arbitrary - we could equally begin, for example, with 
the command root "ip" and discover all commands tiiat follow this root. When Grammar Builder 
45 is activated witibdn tiie system, the "command root" will be provided by the candidate 

30 component 58 being resolved into a resolved grammar 70. 

[0109] In order to discover tiie allowable syntax, at step 1210 an embodiment of the invention uses 
a vendor-specific algorithm to 'Svalk" any command completion or command-line help available, 
and view the options available at each point in the command structure. This algorithm is 
generically called "WalkerViewer." In an embodiment disclosed below, the WalkerViewer 
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algorithm for Cisco's lOS operating system is discussed in detail. Other operating systems and 
other vendors are also supported by modified version of the WalkerViewer algorithm. For 
example, the WalkerViewer algorithm for Cisco's Catalyst operating system differs only in minor 
details. 

5 [0110] The WalkerViewer algorithm for Cisco lOS begins at step 1230 by entering "configuration 
mode" on a network device (often a device in a test or lab networic setting). Within configuration 
mode, the operating system provides "command line completion" of partial commands. When an 
incomplete command is entered, possible '"usxt completions" are available by pressing "?" at the 
end of the partial command firagment. By adding each possible completion to the curr^t 
1 0 command root recursively, all of the possible command options available below a starting root are 
discovered, at step 1240. Tennination occurs in a given **branch" whenever we encounter a 
carriage-return <cr> or "end of line" (EOL) character. 

[0111] A partial example of the syntax tree 80 obtained by running WalkerViewer against the 
command root "ip route" is shown in FIG, 13. For example, when WalkerViewer tests the 
1 5 command root *'ip route" on a network device running lOS 12.2, the following options are 

presented as appropriate in the next position within the command syntax: ''profile" 81, "vrf * 83, 
and "A.B.C.D" 85. The first two are command tokens which trigger fiirther options (and are 
irrelevant for this example). The third is a placeholder for an JP address variable - in this case, the 
destination prefix (as explained in the accompanying text). 

20 [0112J Following the destination prefix fiarther into the tree, we then add a proxy value for 
"A,B.C.D" to the end of "ip route" to form our next command root, and query for possible 
completions. This action results in a single response: "A.B.C.D destination netmask" 87. This is 
added to the partial command string, filling in '^roxy" values for any variables, and the process is 
repeated. 

25 [0113) At each stage in the recursive process, the set of options are added to a syntax tree as a 

series of SyntaxNodes. Each token or variable which can follow a partial coimnand is entered as a 
child of the preceding token. Each SyntaxNode records the specific token, its data type (e.g., IP 
address, word, integer), and other specific metadata about the node. The example shown in FIG. 
13 shows the tree as if we foUow the example command given above: "ip route 10.0,0.0 255.0.0.0 

30 192.168.1.100 10" with a carriage-return (<cr>) terminating the command. The fiiU tree, depictmg 
every possible continuation at each child location, is many times larger. 

[0114] As mentioned above, WalkerViewer will proceed down the syntax tree 80 obtained by 
command completion until every attempt to delve deeper is terminated by an end-of-line character. 
In some cases, however, commands can admit options in any number of locations within a single 

20 



wo 2004/090672 PCT/US2004/0 10424 

line of syntax, which creates repeating "loops" of options as you query command completion. The 
"ip route" example displays a simple example of this looping behavior. The options '"name" 82, 
'^permanent" 84, **tag" 86, and the distance metric 88 can occur in any order, which causes each to 
present the others as possible completions (i.e. as children of each other on the syntax tree 80). 

5 [0115] WalkerViewer handles situation-specific processing of such occurrences, for example by 
accepting a plug-in designed to handle specialized processing needs such as loop processing. One 
plug-in recognizes the situation noted in the previous paragraph: a set of options which can occur in 
any order and may or may not be present. In such cases, the plug-in marks the parent in the tree as 
possessing "children which are allowed to contain loops." This metadata is used below to correctly 
1 0 post-process loops within the syntax tree 80. 

[0116] At step 1250, the output firom WalkerViewer is "raw data" for all subsequent steps in 
processing, and may be a very large and poorly structured tree, from the perspective of human 
compreh^ision. It contains a combinatorial set of all the options available for a given command 
root in all of the orders possible. Additionally, with the entire syntax tree 80 it isn't immediately 
15 obvious where human-perceivable "commands" begin and end. Thus it is helpful to post-process 
the tree into a well-stmctured grammar. 

[0117] In the second phase (Phase II), the raw syntax tree 80 is post-processed mto a grammar 
which includes structure recognizable to a human netv^ork engineer. In the following text, we first 
introduce the details of grammar construction within an embodiment of the invention, and then 
20 cover the four steps involved in post-processing SyntaxNodes into a finished grammar according to 
an embodiment of the invention. 

[0118] In addition to the purely technical requiremmt that we generate grammars which are 
capable of parsing each vendor's commands, an embodiment of the invention also uses the 
grammar as the basis for constmcting many user interface elements. Thus, in an embodiment, we 
25 generate formal grammars which are not only correct but structured in a human-understandable 
manner. Since grammars help auto-generate user interfaces 40 such as configuration editors or 
tree-based views of a device configuration, the grammars of an embodiment of the invention have 
the following conditions: 

[0119] Grammars should be as small as possible, consistent with the need for correctness. Small 
30 grammar size is helpful not only for user comprehension, but overall appUcation performance. 

[0120] Grammars should be as "shallow" as possible. In other words, if the syntax of commands 
is represented as a tree, ttie user should only have to "drill down" the nuiiimum number of levels 
possible to discover an option or command they are seeking. 
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[0121] Grammars should reuse as many common constructs as possible. We should avoid 
duplication whenever possible. 

10122] The algorithms take a tree of SyntaxNodes as output fix>m WalkerViewer, and produce a 
mathematically correct grammar, and then post-process this grammar into a form which attempts to 
5 meet these conditions. 

[0123] The grammars used in m embodiment of the invention are composed of the following 
constmcts: 

[0124] LITERAL - a token that spears verbatim in the command being matched. Groups of 
literals are the key to disambiguating the different "commands" within a vendor's configuration 
10 language. 

[0125] ATTRIBUTE - a token that can have a range of values, often constrained by *type" but 
supplied as data by the user. Types are defined by the language itself and the grammar author. 
Examples include types such as integers, IP address, word, phrase with embedded white-space, and 
soon. 

1 5 [0126] LEST - an ordered set of any of the grammar constructs in the current list. A list such as "A 
B" has the grammatical meaning of "an object of type A followed by an object of type B." 

[0127] OR-BLOCK - an unordered set of any of the grammar constructs in the current Ust. An or- 
block such as "A | B" has the grammatical meaning of "a token of type A or a token of type B may 
occur in this position." 

20 [0128] SECTION - a named grouping of grammar constructs. Sections are a "convenience" in a 
pure sense, simply allowing grammars to 'Veuse" groups of elements by reference. This keeps the 
size of the grammar rule-base small, which is a concern when creating program code to inclement 
the parser. 

[0129] Certain kinds of sections are also used to mark the boundaries of human-understandable 
25 concepts* For example, the final grammar for all of the commands in Cisco's lOS is one giant tree. 
In order to mark segments of the tree which represent the rules for what users would recognize as 
components, or individual lOS commands, we mark certain sections as 'TINAL." In a sinollar 
way, we also mark some sections as "CONTAINER" sections, to organize the tree of commands 
into a hierarchy which mirrors common networking concepts, instead of presenting a flat, 
30 unorganized set of commands. These markers are not true parts of the grammar fix>m a parsing 
perspective, but instead are grammatical metadata used by an embodiment to construct the user 
interface. 

22 
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[0130] Li a similar way, certain positions in a command may admit to a constrained set of literals 

* 

or attributes. These positions can be marked as an ENUMERATION, which really are an OR- 
BLOCXofaUowable LITERALS or ATTRBUTESpennittedinagivenpos^^^ Again, 
enumerations are not necessary for parsing or compiling, but instead represent a grammatical 
optimization used in constructing a user interface which is intuitive and comprehensible without 
knowledge of system internals. 

[01311 As a further simplification, attributes or Uterals which can take only two values ("on" or 
"off") are transfomaed into BOOLEAN constmcts. These do not affect parsing at all, but instead 
are used as an optimization in constructing the user interface. 

[0132] The second phase in granmiar production takes the raw tree of SyntaxNodes developed by 
WalkerViewer, and produce a set of grammar rules. In our simple example, the end result is going 
to be a well-structured grammar which can parse commands beginning with "ip route" and 
containing numerous IP addresses and other data values. 

[01331 The result of processing of the syntax tree 80 is shown in Table 6 below. In contrast to the 
syntax tree 80, note that there is only one '^ath" through the grammar rule, as defined by end-of- 
line characters. Multiple possible paths through the tree of SyntaxNodes have been collapsed into 
altemate or optional sections. The top-level rule is marked as *TINAL," denoting a granomar 
section which corresponds to a single user-perceptible command ~ in this case, our '*ip route. . ." 
example. 

[0134] In the text below we discuss the algorithms for post-processing the syntax tree 80 into 
Table 5 below. 
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CiscoIOSStaticRoute: FINAL. 
•V "loute" 

ATTRIBUTE(ipaddress, **prefix") 

ATTmUTE(forward_mask, **netmask") 

CiscoIOSStaticRouteDestination 

[ CiscoIOSStaticRouteJDistance ] 

[ CiscoIOSStaticRoute JTag ] 

[ CiscoIOSStaticRoute_Penxianent ] 

[ CiscoIOSStaticRoute_NatDe ] 

EOL; 

CiscoIOSStaticRouteDestination: 

Destination_Hop | Destination_;&iterfece; 
Destination_Hop: 

ATTRIBlJTE(q)address, "Gateway") ; 
Destination_Interface : 

ATTRIBUTECword, *1nterfece Name"); 
CiscoIOSStaticRoute_Distance: 

ATTRIBUTE(integer, *T)istance Metric"); 
CiscoIOSStaticRoute JTag: 

ATIRIBUTE(word, 'Tag"); 
CiscoIOSStaticRouteJNiame: 

ATIRIBUTE(word, '*Naine"); 
CiscoIOSStaticRouteJPeimanent: 

BOOLEANCTennanent". ^^ermanenf , "**); 



Table 5: Post-processed component reflecting the "ip route" command with options. 

[0135] Turning to PIG. 14, the first step 1410 is to simply transfonn SyntaxNodes into their 
equivalent grammar constructs through equivalences between SyntaxNode types and grammar 
constructs. Some of the translation rules used include: 

30 [0136] SyntaxNode literal -> grammar LITERAL 

[0137] SyntaxNode data value (any type) -> grammar ATTRIBUTE of the corresponding type 

[0138] SyntaxNode terminal -> grammar EOL (a special token denoting a vendor-specific end-of- 
line character) 

[0139] Each level in the tree of SyntaxNodes is a set of "siblings," which are translated into an 
35 OR-BLOCK. 

[0140] Ancestor/descendant lines through levels in the syntax tree form a LIST. 
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[0141] Transform any nodes marked as "children allowed to loop" in the previous phase into 
grammar sections which are allowed multiple times ^multiply allowed"). 

[0142] The output grammar has no sections, has repeated literals and elements in many places, and 
many EOL terminations, but is technically capable of parsing device input. The results will not 
5 mean much to a human observer, but the grammar is mathematically correct. 

[0143) At step 1420, the resulting grammar is transformed to remove unnecessary EOL 
terminations, and guarantee that each command follows a single path to a single EOL termination. 
Multiple terminations occur because most commands have sets of options which can be used in 
different combinations to form a valid command. 

1 0 [0144] As an example, consider our simple "ip route" command above. The *tag" 86, "name" 82, 
"permanent" 84 and distance metrics 88 can be used alone, or in any combiaation (and in any 
order). Thus, the grammar generated by transforming the syntax tree 80 contains multiple paths - 
one for each ordering and combination of options. We restructure the grammar to "compacf * it and 
produce a simple, clean structure. This is done by examining parts of the grammar where OR- 

1 5 BLOCKS and LISTs contain common elements and re-arranging them into a new set of lists and 
or-bloclcs which lead to a single terminal EOL madcer. 

[0145] Because the grammar for a command root is automatically generated, it may have a 
number of stmctural anomalies which don't affect parsing but are strange to the human user. At 
step 1430 of tibis phase, the grammar is restmctured to eliminate common anomalies. Below is a 
20 list of the some example restructurings. Additionally, each new vendor has the potential to expand 
the list of desired restructuring transformations. The plug-in architecture of an embodiment of the 
invention makes it easy to expand the list of restmcturing transformations to handle changes in 
vendor-specific situations. 

[0146] Common endings that are repeated in OR-BLOCKs are "factored" out. For example, if the 
25 grammar contains the following: 

axy |bxy |cxy 

where a,b,c,x,y are literals or other grammar constructs, we refactor the grammar as follows: 
(a 1 b I c) xy 

(0147] Another common transformation is to find common sub-expressions in nested portions of 
30 the grammar, and "flatten" them into a single list. For example, if the grammar contains the 
following: 

(a|b|c|d(a|b|c)) 

25 
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Where a,b,c,d are literals or other grammar constructs, we refactor the grammar as follows: 
(a|b|c|d)... 

[0148] In this refactoring, the . designation indicates a grammar construct which is allowed to 
occur multiple times. These representations are not precisely equivalent mathematically, but for 
5 practical purposes the resulting grammar correctly parses configuration text and is fer more 
understandable to users. 

[0149) Automatic generation may also leave optional elements "orphaned" within an OR- 
BLOCK. These elements can be "flattened" into a simpler OR-BLOCKj 

[ ^ ] I [ b ] I [ c ] is refactored into a | b | c 

1 0 [0150] Finally, we make a full combinatorial search of the grammar to find segments which are 
repeated. These segments are put into sections (as defined above), and their occurrence replaced 
by reference to the new section. This drastically reduces the overall size of the grammar by 
removing redvmdancy, at some cost to complexity. 

[0151] After the previous step, the grammar is now well structured and nearly ready for use. The 
1 5 grammar, however, is a single tree, with no '^boundaries" which denote where commands begm 
and end. This is mathematically uimecessary for parsing, but crucial for presenting the results of 
parsing to the human user. Thus, in the final step of Phase II, at step 1440, we insert "section" 
constructs within the grammar with FINAL markers wherever command boundaries occur. Each 
command, complete with its suite of options and attributes, is therefore turned into a component 26. 
20 These components 26 are then able to be stored in the component database 28, as fully-fimctional 
and shareable components, and can be reused in policies 34 as desired. 

[0152] The algorithms for marking command boundaries may differ between vendors and 
command languages, necessitating a modular architecture (as with other steps in the Device 
Learning System). In this section, the algoritim for Cisco's lOS and CatalystOS command 
25 languages is described by way of example. This algorithm will also work for any command 
language which has a rigorous form of command negation and command completion on the 
command line. Other embodiments for other vendors and command languages are also possible. 

(0153) Network device command languages typically have 'positive" and **negative" forms for 
each piece of fimctionality. *Tositive" command forms typically activate a piece of functionality, 
30 whereas "negative" corrmiand forms de-activate or "remove" a piece of fimctionality from the 
running network device. This feature helps provide one way of locating command boundaries, 
according to an embodiment of the invention. Thus, by comparing the grammars generated for 
both positive and negative forms of commands, we can locate the nodes within the grammar which 

26 



wo 2004/090672 PCT/US2004/0 10424 

•represent me stan oi a command. This relies upon the fact that the two trees will differ only by the 
syntax required in a given command language for negation. For example, in Cisco lOS and other 
command languages, commands are usually removed by pre-pending **no" to the beginning of the 
command. 

5 [0154] With reference to FIG. 15, at step 1510 we begin with the positive grammar created using 
the methods discussed above. Using the methods discussed above, we also create a negative 
grammar by generating a WalkerViewer syntax tree using the same command root with ' W 
prepended, at step 1520. The remaining stages of grammar production are identical. The result is 
two grammars - one which applies functionality ('^positive") and one which removes functionality 

10 ("negative"). 

[01551 Thus, to find and mark all of the "command boundaries" within the granmiar, we walk 
through the "positive" grammar node by node, at step 1530. At each node, we look at the 
'Negative" grammar to determine if a tenninal end-of-line character is in an equivalent position as 
in the '"positive" side, at step 1540. If it is, we have found the boundary of a "command" and can 
1 5 mark the area of the tree traversed as a FINAL section (the grammar equivalent to a component), at 

9 

step 1550. 

[0156] The final stq) is to merge infomiation iSrom the "negative" grammar tree into the positive 
tree, in order to create a single grammar which has flie abiUty to generate both activation and de- 
activation positive/negative) forms of each command. This is done by transplanting the negative 
20 form of the command into a sub-section of each FINAL section, marking the negative form as a 
REMOVAL, at step 1560. This tag allows the compiler to generate either a positive or negative 
form of a command, depending upon whether the user's action was to add a component to a 
network device, or remove it. 

[0157] Up to this pokit, the grammars produced operate under the assumption that components 26 
25 are "orthogonal" to each other - in other words, that each can be applied and removed without 
affecting any other portion of the configuration 50. Sadly, on many platforms, this assumption is 
imwarranted. The addition or removal of a command firom a device configuration 50 will often 
trigger various "non-local" changes in other aspects of the configuration. In order to fully 
understand the effect that addition and removal has upon a network device 10, the system catalogs 
30 these effects during grammar production. In the sections that follow, these effects are referred to 
generally as the command-level "semantics" of commands (and by extension, components 26). 

[0158] One example of a command-level semantic effect is the necessity of understanding removal 
of a component 26. Removal semantics are actually recorded in an earlier step in grammar 
production because we also "sectionize" the grammar into components 26 at the same time. 
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Command-level semantics can vary by platform, but some common effects seen on network 
devices today include: 

• Commands may have "defaulf ' values for some attributes. On some platforms, when 
the command is issued with default values, it does not appear in the running 
configuration of the device. When the attributes are changed to non-default values, 
the command then "appears" in the configuration. This is largely a cosmetic issue 
rather than a real difference in device fimctionaUty, but firom the perspective of 
configuration management, it is a significant semantic effect. 

® Command attributes may have multiple equivalent formats. For example, port 
numbers in Cisco lOS fi'equentiy have textual equivalents (e.g., port 80 can also be 
entered as 'Vww*'), This is also a cosmetic issue from the perspective of device 
functionality, but from the perspective of configuration managem^t, it too is a 
significant semantic effect, and it is desirable to be able to handle a device that 
silently transfomas one format to another. 

• Connmands vary in their "dupUcation" behavior. In other words, some commands 
must be absolutely unique, whereas other commands may be allowed multiple times 
in a configuration with different values for key attributes. Given the command 
syntax alone, we cannot know this, but in order to guarantee proper configuration 
behavior, this is important information to discover during grammar production. 

• Commands are often 'lied" together in non-obvious ways. Adding one command 
may cause others to appear in the configuration (often at their default value), whereas 

removing a command may cause other commands to disappear from the 
configuration. 

[0159] These are examples of command semantics that appear on a number of platforms across the 
Cisco product line. Platforms from other vendors, for example, include other forms of semantic 
effects. Fortunately, the plug-in nature of an embodiment of the invention allows us to expand the 
set of algorithms for semantic discovery in a seamless and natural way. 

[0160] Examples of the semantic effects we catalog are as follows: 

o Different representations for the same data value (port 80 = 'Svww"). 

o Default values for attributes which cause the command to disappear from the native 
configuration when entered. 

• Dependencies between conq)onents upon addition/removal. 
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• Parameters which make components unique amongst other instances of the same 
component 

• The set of parameters which are important in determining whether a component was 
properly added or removed firom a device during download testing 

5 [01611 Each method for command-level semantic discovery is based on the general method of 
FIG. 16, with specific details for each type of semantics to be discovered: 

[0162] The method begins at step 1610, by selecting a network device with the appropriate 
operating system and version characteristics. At step 1620, the running configuration of the device 
is retrieved. At step 1630, the configuration is perturbed according to the type of semantic data 
1 0 we're gathering. At step 1 640, the running configuration is retrieved again. At step 1 650, the 

diflferences between the "pre" and "post" change configurations are determined. At step 1660, the 
differences are processed according to the specific type of semantics being investigated At step 
1670, the prior steps are repeated, with various combinations tried in order to discover the data 
needed. 

1 5 [0163] Turning to FIG. 17, discovering default values and equivalencies, and otherwise auditing 
configuration behavior is a combinatorial process. Starting with a component (abbreviated as "C" 
in the algorithm below), and a suitable test device, the method proceeds: 

1 . Determine the list of possible attributes for component C. This list will be denoted as 
POSSIBLE^ATTR. (step 1710) 

20 2. Start with a copy ofPOSSIBLE_ATTR that denotes the list ofattributes which are 

usefiil to determining the success of a download onto a network device. This list is 
called the "audit attributes" list, and is scrutinized upon download to determine 
whether a component shows up properly after download. This Ust will be denoted 

AUDrr_Arm. (step 1720) 

25 3. For each attribute (ATTR) in POSSIBLE^ATTR, do the foUowing (step 1730): 

a. Retrieve the configuration of the network device, (step 1 740) 

b. Determine the list of possible values that ATTR can take, (step 1750) If the 
attribute is of a type with a short 'Toiown'* list of values, test each of them. If 
the attribute is of a type with a large (or infinite) list of values, apply a 

30 sampling strategy to test a list of statistically representative values. This list 

of possible values will be denoted as ATTRJVALUES. In some cases, it 
may be necessary to exhaustively test a range of attribute values in order to 
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find the default values. As an alternative, default values can be supplied by a 
human user or "discovered" by parsing the vendor's documentation if 
available in machine-readable format. Also, it may be possible on some 
platforms to query for default values using the command-line interface: 
Cisco's Catalyst OS platform allows this, which would obviate the need for 
exhaustive search, although the procedure is still needed to discover 
auditing/post-download behavior and attribute equivalencies. 

c. For each value (VAL) in ATTR.VALXJES, do the following (step 1760): 

i. Set the value of ATTR in component C of the configuration to VAL. 
(step 1765) 

ii. Apply the configuration to the device, (step 1770) 

iii. Retrieve the new running configuration of the device, and parse this 
configuration into a component tree, (step 1775) 

, iv. If ATTR shows up in component C as VAL, move onto the next 
value (since this is not the "default" value for VAL). (step 1780) 

V. If ATTR doesn't show up in component C as VAL, but other values 
of ATTR (fix)m prior or subsequent iterations of the algorithm) do 
show up as thdr corresponding values (step 1785), then VAL is the 
"default" value, and is marked as such in the grammar for componmt 
C (step 1787). 

vi. If ATTR doesn't show up as VAL, and no other values do either, 
remove ATTR from the list of AUDIT_ATTR, since it cannot be 
reUably tested as part of the post-download test comparison, (step 
1790) 

vii. If ATTR shows up, but in a different format (or even data type) (step 
1793), add it to a list of "equivalency" mappings for the component. 
For example, port numbers will ofl;en be assigned as numbers (e.g., 
80), but will be retumed or displayed in textual equivalents (e.g., 
WWW), (step 1795) 

(0164) The information gathered in the method of FIG. 17 is principally used within regular 
configuration audits and post-download configuration comparisons to ensure accurate tracking of 
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errors. In other words, "dis^pearing defaults" or automatic translation of values which have 
equivalency mappings should not be reported as errors. 

[0165] Turning to FIG. 1 8, discovering which attributes require unique values in order to create a 
unique "instaace" of a component (and thereby, a unique command) is a combinatorial process. 
5 We start with a component 26 , and determine what combinations of its attributes' values can co- 
occur on a device 10. The result of this may be that (a) the component 26 is only allowed once on 
a device 10, or (b) some combination of values of some attributes defines a '^unique" instance of 
the component 26 , where multiple unique instances can exist on a device 10. If we begin with a 
component (abbreviated as '"C" in the algorithm below), the process of deterniining uniqueness is 
10 as follows: 

1 . Start with an empty Ust, to which we will append the names of attributes that denote a 
unique instance of component C, This list will be denoted as IJNIQUE_ATTR. (step 
1810) 

2. Determine the complete list of possible attributes available for component C. This 
15 Ust will be denoted as POSSBLE^ATTR. (step 1820) 

3. Retrieve the running configuration of a test device, (step 1 830) 

4. Determine if the configuration already has an instance of component C present, (step 
1840) If not: 

a. Add an instance of component C, with randomly chosen attribute values (of 
20 appropriate types), to the device configuration, (step 1843) 

b. Apply the configuration to the device, (step 1 847) 

5. For each attribute (ATTR) in POSSIBLE_ATTR, do the following (step 1 850): 

a. Determine the list of possible values for ATTR. (step 1853) If the attribute is 
a type with a short "known" list of values, test each of them. If the attribute is 
25 a type with a large (or infinite) Ust of values, generate a sample of possible 

values that is statistically representative. If the attribute is a type with a 
constrained range of values (discovered by WalkerViewer during Phase I), 
select a sample of values firom within this range. This fist of possible values 
will be denoted as ATTR^VALUES. 

30 b. For each value (VAL) in ATTR_VALUES, do the foUowing (step 1855): 
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i. Add a second instance of component C to the device configuration, 
with VAL for the value of ATTR and otherwise identical to the 
existing instance of component C. (step 1857) 

■ 

ii. Apply the configuration to the device, (step 1 861) 

5 iii. Retrieve the new running configuration of the device, (step 1 863) 

iv. Determine how many instances of component C exist in the new 
configuration (step 186S): 

1 , If only one instance of componmt C exists, we know that 
VAL is not one of the values (if any) for ATTR that makes an 

10 instance ofthe component C unique, (step 1867) 

2. If there are two instances of component C present, we know 
that VAL is one of the values for ATTR that makes an 
instance ofcomponentC a unique instance. Add 
ATTR(VAL) to UNIQUE JVTTR. 

15 6. At the end of this combinatorial search, UNIQUE_ATTR will contain a list of the 

attributes and values for those attributes which cause an instance of component C to 
be unique. This list is added to the grammar as an annotation to component C. If 
UNIQUE_ATTR is empty when the method finishes, this means that only one 
instance of the component can be applied to a device at any one time. Add a notation 

20 to UNIQUE_ATTR that records that component C can only occur once in a 

configuration, (step 1 870) 

[0166] The information gathered on component duplication can be used a number of ways in an 
embodiment ofthe invention. For exdxaple^ a user could be prevented 6om adding two instances 
of a component which can only occur once - instead, the existing instance could be replaced by a 
25 new instance. 

♦ 

[0167] In an embodiment, duplication information may be used in a number of ways to ensure a 
"consistent" and correct final configuration for each network device: 

1 . Every time a policy-driven configuration is compiled into a "native" configuration, 
the list of conq>onents is traversed and any duplicated components are evaliiated 
30 according to their UNIQUE_ATTR list. Duplicates are disallowed if the component 

must be singly present, and if multiple instances are allowed, each instance is 
checked for uniqueness. 
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2. Whenever a component is inserted into a policy-driven (PD) configuration, the 
component is checked to determine if it must be singly present. Since data may not 
have been filled in for attributes at this point, we cannot yet check for uniqueness of 
multiple copies of the same component (this is checked at editing or compilation 
time). 

3. Whenever a poHcy is inserted into a PD configuration, the Ust of components 
contained within the poUcy is checked against the policy-driven configuration. Any 
components which are duphcated between the poHcy and the PD configuration are 
evaluated. Components which must be singly presoit are deleted &om the PD 
configuration and the instance fiom the pohcy is kept Components which may be 
multiply present are evaluated according to their UNIQUE_ATTR lists. If there are 
still "overlaps," given the uniqueness criteria, tiie version from the PD configuration 
is deleted and the version from the pohcy is kept. Retaining the poUcy version and 
deleting the PD configuration version is an implementation-dependent decision, 
designed to place as much reliance on pohcies as possible (in order to give customers 
the leverage of keeping configurations factored into pohcies). In alternate 
embodiments, the components from the PD configurations could be retained and 
those from the policies deleted, or other schemes could be implemented as desired. 

4. Whenever the policy-driven configuration is edited, any change to an attribute value 
is examined to determine if it results in a duphcated component If an edit does result 
in a duphcate component, the dupUcates are evaluated according to their 
UNIQUE_ATTR hsts, and if necessary, an error message can be presented to the 
user. 

[0168] Discovery of dependencies between components is also a combinatorial process. We begin 
with a component, and determine the effect of adding and removing that component (with reahstic 
test attribute data) from a device configuration. The linkages discovered are then added to 
grammar as annotations linking two components. 

[0169] We begin with a component C, to discover its dependencies (if any): 
1. Turning to FIG. 19, to determine dependencies upon addition: 

a. Retrieve the configuration of a test device, caching it for fixture use as PRE- 
CONFIG. (step 1910) 

b. Add a new component C to the configuration, filhng in random values for 
required attributes (of the ^propriate data types), (step 1920) 
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c. Apply the altered configuration to the device, (step 1930) 

d. Retrieve the new running configuration, caching it as POST-CONFIG. (step 
1940) 

e. Parse both cached configurations into a tree of components (step 1 950), and 
5 compare the two trees, producing a list of differences, (step 1 960) 

£ The Ust of differences between PRE-CONFIG and POST-CONHG should 
include component C. Search for, and record, any other components which 
newly appear in the configuration as a result of adding Component C, Also, 
there may be components which "disappear^* with the addition of component 
1 0 C. Add both to the Ust of "addition" dependencies for component C. (step 

1970) 

2. Turning to FIG. 20, to determine dependencies upon removal: 

a. Start with the POST-COISIFIG, which contains component C. Cache this as 
the PRE-CONFIG for removal testing, (step 2010) 

1 5 b. Remove component C firom the PRE-CONFIG. (step 2020) 

c. Apply this altered configuration to the device, (step 2030) 

d. Retrieve the new running configuration fix)m the device, caching it as the new 
POST-CONFIG (step 2040) 

e. Parse both cached configurations into a tree of components (step 2050), and 
20 compare the two trees, producing a fist of differences, (step 2060) 

£ The hst of differences between PRE-CONFIG and POST-CONFIG should 
include component C as a deletion. If no other differences are detected, then 
removal can be marked as firee of dependencies. If not, the hst of differences 
except component C itself constitute the removal dependencies of component 
25 C. Add any differences to the Hst of **removal" dependencies for component 

C. (step 2070) 

[01701 The algorithm discovers removal dependencies that exist within a vendor language. The 
algorithm will discover all newly appearing dependent components in addition or removal 
dependencies, by definition, but it cannot discover a removed dependent component in either an 
30 addition or removal dependency unless the dqpendent component was present in the initial tested 
configuration. This can be remedied by, for example, exhaustive combinatorial testing of 
components in an N x N matrix. Also, performing addition dependency checking first, before 
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performing removal checking, raises the likelihood significantly of seeing an accurate picture of 
removed components, 

[0171] The data on inter-component dependencies is encoded within the grammar as amiotations 
on componoits 26. This data can be used in a number of ways within an embodiment of the 
5 invention. The dependencies can be used within the user's editing interface. When a component is 
added to a policy-driven configuration, dependent components can be added as well. Similarly, 
upon removal, dependent components can be removed if appropriate. The dependencies can 
simply be taken into account during post-download testing of a configuration. For example, if we 
download a new native configuration which removes component A from the device, we should 
1 0 expect the post-download running configuration to be missing component A and any components 
which have a removal dependency upon^d. Snnilarly, if we add con5)onent B to the device, we 
should expect the new running configuration to contain component B and any components (with 
attendant data) which have an addition dependency upon B, These can be used in tandem, or 
separately, within an embodiment of the invention. 

1 5 10172] The system of an embodiment also allows for version control of all editable data in the 
system. In our preferred embodiment, PDC 16, policies 34, device data storage 22, instances 20, 
and components 26 are version controlled within the system. In other words, the component 
database 28 and other data storage entities in an embodiment can be constructed so as to preserve 
the history of changes to each of the stored data items. Example embodiments might use files 

20 stored in a commonly available version control system (e.g., RCS, Microsoft Source Safe); 
alternatives also include storing objects in a SQL database with tables tracking changes to each 
object. Version control, however accomplished, allows detailed tracldng of when and by whom 
each data element is changed, and reconstmction of exact content and stmctural changes to each 
entity. 

25 [0173] When a component or policy changes within the version-control database, the change 

implies that a number of devices (from zero to all of the devices in the inventory) may be affected 
and require new configuration download. The system tracks dependencies between device 
configurations and components/policies, such that changes can quickly be mapped to the set of 
devices requiring update. 

30 [0174] Users won't often have to directly edit tiie grammars which underlie components, but m 
those situations where necessary, the system provides for an editing interface. The driving 
principle for syntax editing is tiiat users should not be exposed to formal grammar specifications 
such as BNF or ASN. 1 . Operatuig directiy upon grammar specifications is not only unfamiliar to 
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most network engineers, but a highly error-prone process with broad ramifications throughout the 
system. 

[0175] Therefore, an embodiment of the invention provides a mechanism for rendering a 
component 26 into a human-readable form which can be edited in a component editor 41 . The 
5 component is compiled by the DLS 44 into its native result, by filling in arbitrarily chosen data 
values for any attributes. The result can be provided to the user in an editor 41 , at which point any 
changes can be presented to the DLS 44 and Grammar Builder 45 for translation back into formal 
grammar 70 and modification of the component 26. The changed component 26 is then saved to 
the component database 28 for fixture use. 

1 0 [0176] The changes are immediately available for ftiture use by the DLS because the changed 
component representation is newer than the cached version of the component, which had 
previously been compiled into an executable parser. This change in the component therefore 
triggers the recompilation of the parsers. 

[0177) In an alternative embodiment, the executable parser is static and never needs recompilation, 
1 5 given a table-driven in^lementation where component changes merely iq)date a table which is re- 
read at every invocation of the parser. This altemative embodiment simphfies the impl^entation 
considerably but does not materially change the results of operation. 

[0178] In general, there is a single granamar specification for a given vendor conamand language. 
In some cases, there may be separate grammar specifications (and thus separate components) for 
20 widely varying versions of a conomand language. There is considerable variation, however, in 
support for features of a typical command language across product models, hardware 
configurations, and software versions. 

[0179] The system handles this kind of variation by allowing a component 26 to possess multiple 
altemative sets of syntax blocks 36, as shown in FIG. 21.. Each alternative set of syntax blocks is 

25 associated with a conditional 37, which is a rule of the form *1f. . .then" which governs when that 
syntax block is used. During compilation of a native configuration from a PD configuration 16, the 
correct syntax block 36 is chosen by determining the most-specific match of device data 12 to the 
conditions specified in the conditional 37. Typical device data used in conditional rules are 
metadata such as hardware platform, software version, or physical hardware interface type. At 

30 least one syntax block 36 is designated as the "default" implementation, and is used to compile a 
native configuration whenever there are no matches between device data 12 and conditionals 37. 

[01801 Component variants can be created by the user, or by Grammar Builder 45 if necessary, 
and may be created at the desired degree of detail - in other words, it is possible to create a 
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component variant which applies to a single hardware platform, running a specific software 
version, using specific hardware card types and firmware versions. This kind of specificity is often 
needed simply to work around bugs and problems in network hardware vendor implementations. 

[0181] Tuming to FIG. 22, native configurations are created by compilation using the device 
5 instance tree and the grammar represented by each component's syntax. This compilation process 
may be performed by the Device Learning System 44, since as noted above, the DLS 44 uses the 
same lexer and parser to do analysis of native configurations as is used to compile PD 
configurations 16 into native configurations. During the compilation process, any outstanding data 
references are resolved, and the final configuration (whether full or incremental) is placed in a 
1 0 staging area (e.g. the device data structure 12) for retrieval and q^pUcation to the physical device. 

[0182] The compilation process begins at step 2210 by taking the fiiU grammar composed from all 
of the stored components (within a given vendor language), and the stored instance tree for the PD 
configuration 16 for the target device at step 2220. These form inputs to a recursive-descent parser 
which emits the target configuration language as its "object code." 

1 5 [0183] In the preferred embodiment, the compiler is written as an LL(0) recursive-descent parser 
because it is difficult to plug an object tree into a standard off-the-shelf LALR parser (e.g., 
Bison/yacc) and emit a configuration. In general, the compilation process recursively walks the 
instance tree at step 2230, emitting literals from the corresponding grammar specification in the 
case of Uteral mstance data. When object data members are encoxmtered, we track the usage of the 

20 reference and only emit syntax corresponding to the data reference once. 

[0184] In the case of Hsts, we recurse through the list, keeping a reference to the current position of 
the output buffer before each recursion step. If a recursion step results in an incomplete output 
string (i.e., an incomplete vendor command string), we retum to the caller and restore the output 
buffer pointer to the position it held prior to the recursion. This prevents the output of incomplete 
25 command strings. 

[0185] Compilation need not always generate a complete native configuration. In addition to 
compiling the ftiU configuration for a device, the system generates incremental configurations, 
which contain only those components and data which are changed since the last configuration 
event. Compilation can start &om any subtree within the PD configuration 16, given an 
30 appropriate grammar subtree that contains needed syntax. 

[0186] Incremental changes to physical devices niinimize the impact of changes to unrelated 
fimctions and in general increases network stabiUty. Full configuration compilation is still usefiil, 
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however, for previewing the impact of changes, testing in laboratory contexts, and for re-generating 
a physical device in the event of hardware failure. 

[0187] Updating physical devices with new configurations is another significant aspect of network 

control. The exact means used to apply configuration changes varies according to the type of 
5 device, and is detennined by the features provided by the device vendor. 

[0188J Turning to FIG. 23, a system in accordance with an embodiment of the invention wraps the 
device vendor's own mechanisms with a process designed to provide safety for the actual change 
execution. We treat application of native configurations to a device as a three-stage process. At 
step 2310, precondition checking is designed to prevent any changes from proceeding in an 
10 environment which is not well-controlled, and is equivalent to an airline pilot's '*pre-flight check." 

[0189] If this check succeeds, at step 2320 we use a software driver which implements a vaidor- 
specific process for applying configuration changes to the device. If errors occur in the application 
process, the configuration is rolled back to the previously running configuration and the problem 
reported to the task owner. If no errors occur, we then perform postcondition checks at step 2330, 
15 to verify that the device is being left in a fimctional state, 

[0190] To be more specific, the download process operates according to a strict contract, modeled 
after interface contracts in object and component-oriented programming. CSianges cannot occur if 
preconditions are not estabHshed, or the results of a change cannot be predicted. And a change 
cannot be considered complete until postconditions are estabUshed. 

20 [01911 Precondition checks are performed prior to any software-mediated change to a device 

configuration. In order for a change to be "safe" to apply, the physical network device must be in a 
known and predictable state. For example, if the device firaiware or operating system version has 
changed since the last configuration was compiled, our software cannot guarantee that the new 
configuration will work in a predictable manner. 

25 [0192] Thus, precondition checkmg seeks to establish the "environmental state" of a network 
device prior to applying a configuration change. We attempt to establish the invariance of: 

• Hardware platform 

• Installed hardware if a modular architecture 

• Operating system software or firmware version 
30 o Running configuration version 

[0193] If any of these environmental factors is different than expected, we do not allow the 
configuration change or download to proceed. Additionally, we may collect fimctional data about 
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a aevice, to aid in the process of assessing proper operation following application of the pending 
change. 

[01941 Postcondition checking is different than the precondition test in that we seek to determine 
whether the network device is functiomng properly, following appUcation of a configuration 
5 change. When making postcondition checks, we typically seek to estabhsh that interfaces 

designated as "up" are passing traffic, establish that the routing table differs in '"predictable" ways, 
and so on. 

[01951 Much of the postcondition functionality checking is implemented as pluggable modules in 
a scripting language. This allows the system to respond quickly in the face of changes to vendor 
1 0 commands or command output formats, and to allow professional services or third-parties to easily 
extend this phase of testing. 

[0196] A complete system for controlling network devices should ensure that network devices 

* 

continue to implement appropriate poUcies, even after the configuration is appUed and tested. 
Engineers might change the device configuration manually in the course of troubleshooting or 
1 5 maintenance. More rarely, unauthorized changes can be made, either by employees or by intrusion 
from outside the customer organization. 

[0197] The system performs periodic auditing of all production network devices, to detect changes 
to a network device which did not originate within the change control process of an embodiment of 
the invention. The auditing interval is configurable, and often will be performed at least once per 
20 day (if not more often). 

[0198] Turning to FIG. 24, basic periodic auditing has five steps. At step 2410, the running 
configuration for a device 1 0 is retrieved. The most recent version of the PD configuration 1 6 is 
retrieved firom tiie component database 28 in step 2420. This version of the PD configuration 16 is 
what the systrai believes should be present on the device, absent any changes fiom outside sources. 

25 At step 2430, the running configuration is passed to the DLS 44 and parsed into a PD configuration 
16 as well. Next, m step 2440, the two PD configurations 16 are compared by walking the two 
trees of instances 20 in tandem, noting any components 26 or policies 34 that occur in one PD 
configuration but not the other. If the resulting Ust of missing components 26 or policies 34 is 
empty, then the network device 10 has not be altered since the last time the system performed a 

30 change to its configuration. Otherwise, the list of missing components or pohcies is stored as the 
result of the audit, along with the date and time of the audit, for presentation to users within the user 
interface 40. 
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[0199] In addition to basic auditing to monitor changes that arise from outside the system, the 
system monitors the Unkage of policies 34 to PD configurations 16 in order to ensure that the 
design of the network remains as the user intends. This process is depicted in FIG. 25 . In step 
2510, a hst of network devices is created The system then selects each device in tum (step 2530) 

5 until the Ust is exhausted (step 2520). At step 2540, the list of policy linkages 35 is retrieved, 
followed by retrieval of the device's running configuration in step 2550. In step 2560, the running 
configuration is parsed by the DLS 44 into a PD configuration 16, The system thotn selects each 
policy linkage 35 for the device in tum (step 2575) until the list for that device is «diausted (step 
2570). At step 2580, we examine the PD configuration 1 6 to deteniiine whether the poHcy 34 

1 0 represented by the selected poUcy linkage 35 is present. If it is present, we simply move on to the 
next policy hnkage. If the policy is not present, we add the policy hnkage 35 to a Ust of missing 
poUcies (step 2585). When all devices have been processed in this manner, we record the hst of 
missing pohcies as the result of the audit (step 2590). An empty hst indicates that all pohcies 34 
are present where the users of the sj^tem intend them to be. A hst with missmg poUcy hnkages 35 

1 5 indicates that some devices have departed (through manual changes or mistakes in editing within 
the system) fix>m their intended design. 

(0200) The system incorporates a reporting engine which allows the user to perform standard types 
of usage reports. Typical reports would be hsts of devices requiring updated configurations, the 
results of basic or poUcy hnkage audits, hsts of tasks broken down by user, reports on job and task 
20 completion and schedules, and the history of any device, poUcy, or component in the database. 
These reporting engines are well-known in the art. 

[0201] hi the foregoing specification, the invention has been described with reference to specific 
embodiments thereof It will, however, be evident that various modifications and changes may be 
made thereto wifliout departing from the broader spirit and scope of the mvention. For example, 

25 the reader is to understand that the specific ordering and combination of process actions shown in 
the process flow diagrams described herein is merely illustrative, and the invention can be 
perfomaed using different or additional process actions, or a different combination or ordering of 
process actions. Features and processes known to those of ordinary skill m the art of network 
management systems may similarly be incorporated as desired. Additionally, features may be 

30 added or subtracted as desired. The specification and drawings are, accordingly, to be regarded in 
an illustrative rather than restrictive sense, and tiie mvention is not to be restricted or hmited except 
in accordance with the following claims and their legal equivalents. 
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WE CLAIM: 

1 . A network management system for managing a plurality of network devices, comprising: 

a device database for storing a native configuration for one of the plurality of network 
devices; 

a component database for storing configuration information used to configure the plurality 
of network devices, wherein the configuration information is stored as a plm'ality of components 
and a plurality of candidate compon^ts; 

a device learning module for receiving the native configuration from the device database, 
identifying the configuration information from the native configuration, and storing the 
configuration information in the componrat database; and 

a grammar builder for receiving a candidate component, resolving the candidate component 
into a component, and storing the component in the con^onent database. 

2. The system of claim 1 , wherein the configuration information identified from the native 
configuration information comprises a policy. 

3. The system of claim 2, wherein the pohcy comprises a pluraKty of components. 

4. The system of claim 2, wherein the poUcy comprises a template adapted to aggregate together a 
plurality of components all sharing a common attribute. 

5 . The system of claim 4, wherein the conraion attribute comprises membership in a network 
configuration fimction for one of the plurality of network devices. 

6. The system of claim 1 , wherein the plurahty of components comprise a pohcy-driven 
configuration for one of the plurahty of network devices. 

7. The system of claim 1, wherein each component comprises a component syntax block. 

8. The system of claim 1, wherein each component comprises a configuration coxmnand for a 
configuration command language, the configuration command adapted to configure a function 
on the network device. 

9. The system of claim 1 , wherein the configuration information identified from the native 
configuration information comprises a candidate component 

10. The system of claim 1, wherein the grammar builder receives the candidate component from 
the device learning module. 

11. The system of claim 1, wherein the grammar builder receives the candidate component from 
the component database. 

12. The system of claim 1, wherein the device learning module fiirther comprises a lexer adapted to 
tok^iize the native configuration, and a parser adapted to parse the tokenized native 
configuration to identify a plurahty of components and a candidate component within the 
tokenized native configuration. 
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13. The system of claim 12, wherein the parser is configured to identify the plurality of 
components and the candidate component by comparing the tokenized native configuration to 
the configuration information stored in the component database. 

14. The system of claim 13, wherein the parser is adapted to identify the candidate component by 
detecting a portion of the tokenized native configuration that does not match the configuration 
information stored in the component database. 

15. The system of claim 13, wherein the parser is adapted to identify the plurality of components 
by detecting portions of the tokoaized native configuration that match the configuration 
infomiation stored in the component database. 

16. The system of claim 12, wherein the lexer is configured to tokenize the native configuration 
according to a grammar embodied in the configuration information stored in the component 
database. 

17. The system of claim 12, wherein at least a first portion of the lexer and the parser are 
recon:q)iled each time the device learning module receives a native configuration. 

18. The system of claim 17, wherein a second portion of the lexer and die parser remains constant 
across multiple receptions of native configurations. 

19. The system of claim 12, wherein tiie device learning module finlher comprises a policy 
matcher, adapted to parse the plurality of components and recognize a policy contained in the 
plurality of components. 

20. The system of claim 19, wherein tiie device learning module is adapted to output a policy- 
driven configuration and zero or more candidate components. 

21. The system of claim 1, wherein the device learning module is adapted to compile a policy- 
driven configuration into a native configuration. 

22. The system of claim 1, fiirther comprising a device data storage for storing device-specific 
infomiation about the plurality of network devices. 

23. The system of claim 1, wherein the grammar builder is adapted to retrieve command root 
completion information fi?om one of the plurality of network devices, create a plurality of 
command root derived components firom the command root completion information, and 
resolve the candidate component into a component by comparing the candidate component to 
the plurality of command root derived components, to identify one of the plurality of command 
root derived components that matches the candidate component. 

24. A method of parsing a native configuration into a policy-driven configuration, comprising: 

receiving configuration inforaaation comprising a pluraUty of components; 

receiving the native configuration; 

tokemzing the native configuration using a lexer module; 
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parsing the tokenized native configuration using a parser module, to identify a,plurality of 
input components contained in the native configuration and match the plurality of input 
components with the plurality of components; 

parsing flie tokenized native configuration using the parser module, to identify one or more 
unknown regions contained in the native configuration, which do not match any of the plurality of 
components; 

emitting a tree of components, comprising the plurality of matched input components and 

the one or more unknown regions; 

processing the one or more unknown regions to identify one or more candidate 

components; 

analyzing the tree of components to identify one or more policies present in the tree of 
components; and 

outputting the one or more policies and the one or more candidate components, as a poUcy- 
driven configuration. 

25. The method of claim 24, finrfher comprising: 

compiling the lexer module using the configuration information, such that the lexer module 
is adapted to tokenize tiae native configuration according to a grammar embodied in the 

configuration information; 

compiling the parser module using the configuration infomiation, such tiiat flie parser 
module is adapted to match the tokenized native configuration to the configuration information; 

26. The method of claim 24, fiarther comprising reorganizing the tree of components to enhance 
user comprehension of the tree. 

27. The method of claim 24, fijrther comprising compressing the tree to remove unnecessary data 

from the tree. 

28. The method of claim 27, wherein the unnecessary data comprises an empty node in the tree. 

29. The method of claim 24, wherein the plurality of components comprises a policy, and 
analyzing the tree of components comprises: 

retrieving the poHcy; 

comparing each of the pluralify of components in the policy with tiie plurality of matched 
input components contained in the tree of components; 

aborting tiie analysis if any of the plurality of components in the poHcy is not found in tiie 

plurality of matched input components; and 

identifying the policy as present in the tree of components if all of the pluralify of 
components in the policy are found in the plurality of matched input components. 
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30. ilie method of claim 29, further comprising removing all of the components in the plurality of 
matched input components that were matched to the plurality of components in the policy, and 
inserting the policy into the tree of components. 

3 1 . The method of claim 29, whorein the policy comprises an ordered policy, and identifying the 
policy further comprises identifying the ordered policy as present in the tree of components if 
all of the plurality of components in the ordered policy are found in the plurality of matched 
input components in the same order as in the ordered policy. 

32. The method of claim 24, wherein parsing the tokenized native configuration to identify one or 
more unknown regions conoprises: 

detecting a parse error, wherein the parser fails to recognize a portion of the tokenized 
native configuration; 

marking the portion for further processing; and 
continuing to parse the tokenized native configuration. 

33. The method of claim 24, wherein processing the one or more unknown regions to identify one 
or more candidate con^onents comprises: 

walking the tree of components; 

marking each of the plmrality of matched ixsput components in the tree of components; 
re-waDdng the tree of components; 

identifying a token within one of the one or more unknown regions wi thin the tree of 
components. 

walking the tree of components in each of two directions, beginning at the identified token, 
to identify a beginning point and an end point of the unknown region; and 
marking the unknown region as a candidate component. 
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